home *** CD-ROM | disk | FTP | other *** search
/ HamCall (April 1991) / HAMCALL CD-ROM (Buckmaster)(April 1991).BIN / geograph / sunrise / read.me next >
Text File  |  1990-10-14  |  11KB  |  282 lines
  1.  
  2.  
  3.  
  4.  
  5.                                 SUNRISE PROGRAM
  6.                                        by
  7.                                 John Hendrickson
  8.  
  9.  
  10.     INTRODUCTION
  11.  
  12.     The SUNRISE program will calculate and print the times of sunrise and
  13.     sunset for an entire year for a given location on a single 8" by 11"
  14.     sheet of paper.  The results are extremely accurate, and in most cases
  15.     will be well within the nearest minute of the actual times.  The
  16.     program will compute sunrise and sunset times for any place in the
  17.     world, and for any year in the next few centuries.
  18.  
  19.     On most computers it will take about a minute to run; the output will
  20.     be sent to your printer, which must be able to support a condensed or
  21.     compressed mode.  The program uses IBM/Epson escape codes to set your
  22.     dot-matrix printer to compressed mode and also instruct it to print
  23.     eight lines of text per inch.
  24.  
  25.     To see a quick demonstration, just type DEMO and press the RETURN key.
  26.  
  27.  
  28.     EXECUTION
  29.  
  30.     To start SUNRISE, just type  SR  and press RETURN.  The program begins
  31.     by reading the data file, SR.DAT.  After about 20 seconds it will
  32.     begin requesting input about the year, location, time zone, and
  33.     whether or not daylight-saving time is to be used.
  34.  
  35.  
  36.            SAMPLE SESSION
  37.  
  38.            A sample interactive session for Indianapolis (which does not
  39.            use daylight-saving time) appears below, followed by a more
  40.            detailed explanation of each query.
  41.  
  42.  
  43.  
  44.                    ...SUNRISE PROGRAM...
  45.                       version 2.21
  46.  
  47.                     by John Hendrickson
  48.  
  49.  ENTER IN LAST TWO DIGITS OF YEAR? 89
  50.  
  51.  NAME OF LOCATION?   Indianapolis, IN.
  52.  
  53.  LATITUDE AND LONGITUDE SHOULD BE ENTERED IN THE FOLLOWING FORMAT  LL.MM
  54.  WHERE LL IS IN DEGREES, AND MM IS IN MINUTES
  55.  
  56.  LATITUDE?  39.44
  57.  LONGITUDE? 86.16
  58.  TIME ZONE IS BASED FROM WHICH MERIDIAN? 75
  59.  Convert to DAYLIGHT-SAVING TIME... (Y/N)? NO                     12 Hour clock
  60.  
  61. (At this point a menu will appear where additional options can be selected).
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.     DETAILS ON ENTERING IN DATA
  72.  
  73.     When SUNRISE is first started, the data file SR.DAT is read by the
  74.     program.  After about 20 seconds, you will be will be prompted to enter
  75.     the last two digits of the year for which you want to calculate.  You
  76.     can either enter all four digits (e.g. 1989), or two digits (e.g. 89).
  77.     If you simply enter a carriage return without typing any data, the
  78.     current year (from the system clock) will be used.
  79.  
  80.     Next you will be asked for the name of the location.  You can type in
  81.     anything here.  Whatever you type will be the name that is used on the
  82.     Sunrise/Set printout.
  83.  
  84.     Then you will be asked the latitude and then the longitude of the
  85.     subject location.  Both the latitude and longitude should be entered in
  86.     degrees and minutes (e.g. 39 degrees, 44 minutes would be entered in as
  87.     39.44).  Use negative numbers for locations in the eastern or southern
  88.     hemisphere.
  89.  
  90.     Now you will be prompted to enter in the meridian (longitude) for the
  91.     desired time zone.  Below are some values that you would use for time
  92.     zones near the United States.  Just enter the appropriate number.
  93.  
  94.     GMT would be 0 degrees   (Greenwich Mean time)
  95.     AST would be 60 degrees  (Atlantic Standard Time)
  96.     EST would be 75 degrees  (Eastern Standard Time)
  97.     CST would be 90 degrees  (Central Standard Time)
  98.     MST would be 105 degrees (Mountain Standard Time)
  99.     PST would be 120 degrees (Pacific Standard Time)
  100.     YST would be 135 degrees (Yukon Standard Time)
  101.     HST would be 150 degrees (Hawaii, and Alaska Standard Time)
  102.  
  103.     If you have selected a location near North America, you will then be
  104.     asked whether or not you want to adjust for daylight-saving time.
  105.     Enter a "Y"  or a "y"  if you want the output to reflect
  106.     Daylight-Saving Time.  Any other keys will mean NO.
  107.  
  108.     Note: Daylight-Saving Time is not used in other parts of the world
  109.     outside of the continental United States or Alaska.  The
  110.     daylight-saving time option will add 1 hour to all the times between 2
  111.     AM on the first Sunday in April, and 2 AM on the last Sunday in
  112.     October.
  113.  
  114.     You can also force daylight-saving time by typing:
  115.  
  116.        SR YES        when you first start Sunrise.
  117.  
  118.     The "YES" will always turn on daylight-saving time no matter the
  119.     location.  Typing SR NO will always force daylight-saving time off.
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.     USE OF THE MENU
  130.  
  131.     A menu has been provided so that you rerun the program several times
  132.     without entering all new data.  If you are just printing out the
  133.     Sunrise/Set times for one location, you can ignore this section; just
  134.     hit any key other than F1 through F8 to continue.
  135.  
  136.     After all of the data is entered, a menu will appear on the screen that
  137.     looks something like this:
  138.  
  139.                  HIT ONE OF THE FOLLOWING KEYS:
  140.  
  141.     F1 - to change year                F2 - to change location
  142.     F3 - to change time zone           F4 - to toggle daylight-saving time
  143.     F5 - to re-enter all new data      F6 - toggle between 12/24 hour clock
  144.     F7 - change output device or file  F8 - Print Sunrise/Set times and
  145.     ESC- to end program                     then return to menu
  146.           -OR-
  147.     HIT ANY OTHER KEY TO PRINT SUNRISE/SET TIMES...Program will end upon
  148.     completion.
  149.  
  150.     Here is a brief description of each:
  151.  
  152.     F1-    Will only allow you to reenter the year.  Nothing else will be
  153.            changed.  Afterwards, you can select another menu option.
  154.  
  155.     F2-    Will only allow you to change locations.  Everything else will
  156.            remain the same.  Afterwards, you can select another menu option.
  157.  
  158.     F3-    Will only allow you to change time zones. Afterwards, you can
  159.            select another menu option.
  160.  
  161.     F4-    Will toggle daylight-saving time to YES or NO.
  162.  
  163.     F5-    Use this option if you want to enter all new data without exiting
  164.            and restarting the program.  This way the data file SR.DAT does
  165.            not have to be reread.
  166.  
  167.     F6-    Will temporarily change the default output device or file to
  168.            something else.  This change will only remain in effect until you
  169.            exit the program.  To make this change permanent you must edit
  170.            SR.DAT and change LPT1 to something else.  SEE REDIRECTING OUTPUT
  171.            FOR MORE DETAIL ON THIS.
  172.  
  173.     F7-    Will toggle the printout to a 12 hour or 24 hour clock.
  174.  
  175.     F8-    This will print out Sunrise/Set times for the location, year and
  176.            other options you have selected.  After the table has been
  177.            printed, the menu will reappear on the screen so you can make
  178.            changes for your next run.
  179.  
  180.     ESC    Will end the program immediately.
  181.  
  182.     HITTING ANY OTHER KEY than one of the function keys will also print out
  183.     the Sunrise/Set times.  However, the program will terminate upon
  184.     completion.
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.     REDIRECTING OUTPUT TO ANOTHER DEVICE OR FILE
  192.  
  193.     The SUNRISE standard output is normally sent to the LPT1 device
  194.     (printer 1). However, if you are printing out a large number of
  195.     Sunrise/Set charts at one time, you may want to redirect the output to a
  196.     file rather than to the printer.  By redirecting the printout to a file,
  197.     you do not have to wait for each chart to print, since they will store
  198.     much faster on a disk. After you are done, you can copy this file to the
  199.     printer and each chart will print out without your assistance.
  200.  
  201.     To temporarily redirect the output to a file or another device, just hit
  202.     the hit the "F7 Key" when the menu appears.  It will next display the
  203.     current output device or file and then prompt you on what you want to
  204.     change it to.  If you do not want to make any changes just hit enter to
  205.     continue.  Otherwise type in the name of the file or device.  MAKE SURE
  206.     WHATEVER YOU TYPE, IS A VALID DOS EXPRESSION.
  207.  
  208.     This change will remain in effect until you exit the program.
  209.  
  210.     You can also make this change permanent by editing the SR.DAT data file.
  211.     All you have to do is to change "LPT1" near the end of this file SR.DAT,
  212.     to another name.  A backup copy of SR.DAT should be first made in case
  213.     this file is accidentally damaged.  Be sure to use a true ASCII text
  214.     editor and change nothing else in this file.
  215.  
  216.  
  217.     TWELVE AND 24 HOUR CLOCK
  218.  
  219.     Normally this program will print out the Sunrise/Set times in a 12 hour
  220.     clock mode.  However, you can toggle it to a 24 hour clock or back by
  221.     hitting the "F6 Key" when the menu appears.  This change will only remain
  222.     in effect until you exit the program.
  223.  
  224.     If you desire to only use the 24 hour clock mode, you can change this
  225.     default setting to the 24 hour mode by editing SR.DAT.  At the very end
  226.     of SR.DAT is the number 12.  Just change this to 24.  Make sure nothing
  227.     else is changed and you are using a true ASCII text editor.  Also keep a
  228.     backup copy of this file (SR.DAT) in case it is accidentally damaged.
  229.  
  230.  
  231.     USING BATCH FILES
  232.  
  233.     Batch files can be used along with redirected input files to process
  234.     Sunrise/Set tables automatically.  The sample file, DEMO.BAT, will run
  235.     the SUNRISE program using INDY.DAT to provide all the input.
  236.  
  237.     Other batch files can be created, along with additional input files, to
  238.     process many different locations and/or years at one time, automatically.
  239.  
  240.     NOTE...The menu keys cannot work from the batch file.  If you want to use
  241.     daylight-saving time from the batch file you must type type in
  242.  
  243.     SR <INFILE YES        The "INFILE" is the name of the input file.
  244.                           The "YES" will force daylight-saving time on.
  245.  
  246.     Also to use the 24 hour clock or another device or file instead of
  247.     printer 1 for your output, you must edit SR.DAT beforehand.
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.     NOTE ON NON-IBM or NON-EPSON COMPATIBLE PRINTERS
  256.  
  257.     When the data is printed out. Escape codes are used to place the printer
  258.     in compressed mode, and instruct it to print eight lines per inch.  This
  259.     is necessary since each of the 78 lines is about 130 columns long.  You
  260.     should have no problems if you are using an Epson or IBM Compatible dot
  261.     matrix printer.  However, other types of printers may fail to recognize
  262.     these codes.
  263.  
  264.  
  265.     OTHER INFORMATION
  266.  
  267.     This program should run on just about any IBM compatible computer using
  268.     PC or MS DOS 2.0 or later.
  269.  
  270.     There is no charge for SUNRISE.  However, if you find this program
  271.     useful, a $10.00 contribution would be greatly appreciated.  Also you can
  272.     send any suggestions for future improvement to me at the following
  273.     address:
  274.  
  275.  
  276.            John Hendrickson
  277.            7715 White Dove Dr.
  278.            Indianapolis, In. 46256
  279.  
  280.  
  281.  
  282.